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YOU CAN ANIMATE YOUR OWN CHARACTERS .. 
WITH PLAYER MISSILE GRAPHICS (PMG)I 


Ok I You spent your hard earned money on this program 
because everyone says that Player Missile Graphics Is the 
way to go, but you know It Is too hard to ever really 
understand. Besides, you bought $25 worth of magazines for 
the two page articles on the subject, and they all said the 
same thing (which made little sense to you). After all that, 
you got ATARI'S book, DE RE ATARI, which was great reading, 
but Chris Crawford only explains the basic capabilities of 
PMG. How do you put It all to practical use? Well. 

Were Going to 
Write a GAMEI 

Most of us like to play arcade games, and since most 
arcade games use cute little figures and a maze, we will 
design our game that way. One of my favorite games Is called 
PACMAN (tm). We can't actually use the same game as the 
arcades due to legal problems, but we can take the cute 
little character and put him Into our our own hair raising 
sItuatI on I 
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All games take Imagination. Let*s put ours to work 
making up all kinds of shapes to animate and ”play" with on 
the screen. Some of these characters will be used In 
demonstrations within the 14 main programs. You can take 
over where these lessons leave off and create any kind of 
application you wish. PIayer/MIssI Ies Is not Just for games. 
Any time you need color or movement In your programs PMG Is 
the best way to get the Job done. For example, ATARI'S 
SCRAM program, a Nuclear Plant Simulator uses Players and 
Missiles for the various tanks and mechanisms on the screen. 

WHAT IS A PLAYER/MISSILE? 


The names Players and Missiles come from the original 
use of these objects as guns (for the Player to use) and 
bullets or Missiles for the "shot" that was fired. Now, of 
course, many other uses exist, but the names are still used. 
Let's begin by looking at the original use of PMG, a space 
game demonstration. Run the first program now and follow 



LOADING INSTRUCTIONS 


Before I begin, some special notes are needed to help 
tape users and those with only 16K of memory. When teaching 
about Player Missile Graphics, I can't help but get carried 
away. Orble, Pixel, and I were having so much fun, that we 
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wrote too many examples for this TUTORIAL. Once you finish 
this lesson, you will find yourself creating all kinds of 
animated creatures! Fortunately, my Robot helper. Prototype, 
ate a few of the programs, leaving us with just enough 
examples to fit a very full tape. 

Because of the length of the lesson, some of you may 
have trouble reading In the programs on your 410 tape 
player. You will have to get 14 successful LOADS; so, as you 
LOAD each program , SAVE It on your own backup tape. Before 
you start, wind the tape forward and backward once. To load, 
reset your recorder’s counter to zero. Now type RUN ”C;” 
and press return twice. The tape should begin to load Into 
memory. There Is a backup copy of all examples on the back 
of your tape, but If loading still produces an error 
message, you have two options: 

1) Rewind the tape to zero, take It out, and listen to It 
In a regular cassette player. Listen for the beginning of 
the steady tone that preceeds the digital signal. This tone 
will continue for about 20 seconds, then the program begins 
to load. If you are not sure the tape Is at the beginning. 
Just rewind or advance It a little bit until you find a 
place where there Is no steady tone, then move back to the 
start of the tone. Now place It back Into the 410 recorder 
and reset the counter to zero since you now know this Is the 
right place. If the tape loads from here... great. Remember, 
SAVE each program as you get a successful LOAD on another 
backup cassette. Prototype sys to remind you to write down 
the number your Tape player shows where each of these 14 (12 
for 16K users) examples start. This would be a good habit to 
develop when using anyone’s cassette based program. 

2) You can ”guess** at the correct spot by going back ar 
forth until you get lucky, but that Is very frustrating! 


Don’t forget. If any program doesn’t load properly, you will 
find backup copies on the reverse side of the cassette. If 
the program STILL doesn’t seem to load properly, try another 
recorder (perhaps at a store or a friends house). If you are 
so upset at the darn thing you want to buy a disk drive, 
send It back for a prompt (I hope!) replacement to: 
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16k Users 


I haven’t forgotten you. All programs on this tape 
except the two utilities will run on your machines. The 
utilities are very nice, but not necessary, so Just save 
them until you Increase your memory size to 32K. Example 
5.4, the Playfleld editor. Is out of order on your tape. It 
will be found after example 5.13 (Two players together), 
which Is the last example that runs In 16K. Finally comes 
example 5.14, the last editor, which also requires 32K. 

- HOW TO USE THIS MANUAL - 


Without the Information In this manual, these programs 
are rather boring. Only when you understand what Is being 
shown In the examples will PIayer/MIssIe Graphics (PMG) 
begin to make sense to you. In fact, after you have written 
your first real game or business application you’ll feel a 
wonderful sense of acompI Ishment I 



As you progress you may find yourself lost on a certain 
subject. IMMEDIATELY refer to the FOLLOWING CHART to see 
which examples demonstrate the feature In question. Note 
that I refer to Example 5.1 as 1 since we all know this Is 
Tutorial #5. When the chart says ’’others” this means that 
the other examples listed demonstrate the topic also, but 
not as well as those listed. Here then Is : 
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THE EOLL.OUI IIMO CMART 


TOPIC 


SEE EXAMPLES 


General Features of PMG . 

Playfields (backgrounds) .... 

Color Selection & Pokes . 

Memory Area for PMG . 

How to Draw a Player . 

Missiles used as a Player ... 

Joystick or Paddle? . 

Use of Sound with PMG . 

Moving Players and Missiles . 
Size of Players and Missiles 
Single/Double line Resolution 

How to Animate a Player . 

Priority . 

Co I I I s I ons . 

Two Players as one . 

Comp Iete Game .. 

PMG using Strings . 

Poke and Peek Table . 


EX^MF>LE S- j. 


1.2.14 

2.4.8 

5 

7 t others 
6,7,14, others 
5, 14 
7 

1 . 2.8 
1 , 2 , 6 , 7,9 

6.14 
10 

2 , 11,12 

2,12 

2,12 

13 

2 

4.14 

Append I x 



If you are new to the ATARI computer, watch this example 
many times and look at It later as each subject Is 
mentioned. Here Is what you are seeing. First, the screen on 
your TV goes black, because I turned off the display 
processor, called ANTIC, accomplishing two things: 


1) Speeding up the machine by 30?, and 

2) Making the background of stars suddenly appear, 
rather than seeing them slowly drawn out. 


You can compare this to watching the background drawn out In 
the next program and choose which method to use. If you 
decide to turn off the screen display while YOUR backgrounds 
are drawn, here’s how: 
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At the point you want 
100 0N=PEEK(559);P0KE 

.(PROGRAM CODE TO 


500 POKE 559,ON 



Later 1*11 teach you what the correct number for ”0N** is, 
but you can always Just save the old value as I did above. 
The number In memory location 559 will have to be changed 
later to allow PMG to work. 
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Yes, the ATARI does have two microprocessors. The ANTIC 
Is a special one that Is used to draw the screen on your TV 
or Monitor. It does both graphics and text. Whenever It Is 
In use. It "steals cycles** from the main microprocessor, the 
6502. This Is why the computer Is faster when the screen Is 
bIank(559=0).... the main processor runs at full speed If It 
doesn*t have to stop all the time to allow the ANTIC time to 
draw the screen. 




Are you still In Program 5.1? Good, don*t rush ahead. 
This Is going to take time to explain properly. 

The computer has a nice bunch of **stars** on the screen. 
Some are red and some blue. This is because when we plot 
single points In Graphics 8, the TV can only light up either 
a blue or a red pixel on the screen. If you look real close 
at your tube you will see these tiny pixels of red and blue. 
These background stars are called a PLAYFIELD when 
discussing PMG. If you look at the graphics chart on page 53 
In your BASIC manual, you’ll see that most graphics modes 
allow from one to four colors. Modes 9 to 11 have more, but 
still only four of the colors pertain to the following 
discussion. 

When you enter color 1, and then draw out some shapes on 
the screen, you are drawing what Is called PLAYFIELD 1. 
Likewise, If color 2 or 3 Is allowed In the graphics mode 
you are using, these would be PLAYFIELD 2 or 3. The fourth 
playfleld Is actually color 0, the background color that you 
get when you start out In a graphics mode. All of these 
colors can be controlled. 
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I usually set the border to the background playfield 
color so the whole screen appears the same. Notice how the 
stars don't actually go to the edge of the screen, but since 
the Players can move anywhere, having the border the same 
color makes the playfield seem larger. 


At last we have two Players on the screen. It has been a 
long winded discussion, but there they are. And, oh my! They 
move! Oh, you knew they could? Well, I guess there Is no 
suprising you. Notice how easily BASIC can move them 
HORIZONTALLY across the screen. Now look at the listing for 
this program. Notice 5 lines (400 to 440) control the sound 
and movement (You ARE going to study the code, aren't you?). 
Next, the Players grow In size. This capability also Is a 
simple POKE of a number, and will be explained later. 


Finally our space battle concludes with one ship firing 
missiles at another until they both are destroyed and the 
example Is over. Run the example again until you are sure 
what the following mean; 
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OUFl COMF^L-ETE Oi^fcME 
EXiP^MF^L-E S.S 


Rather than talk about some strange Ideas like collision 
registers now, I thought you would like to see and play with 
the goal of this Tricky Tutorial, an actual game using all 
of the feature of PMG, Now before you begin, please realize 
that our goal did not Include producing a game just like the 
arcades. Those are written in machine language with special 
display tubes to allow very fine graphics. We just want to 
demonstrate ail of the topics you will be learning later In 
one program. For the hot programmers In the audience, the 
game can be expanded to be quite a lot of fun. As it is now, 
it just fits in 16k which was required for our friends with 
ATARI 400»s (and there are a lot of you out there). 


The "rules” of the game are easily changed. In fact, 
the first thing you might do when you finish the complete 
lesson is to change the game to your own specifications. 
Most changes will be surprisingly simple. IMI offer some 
hints when the game is explained at the end of the Tutorial. 
Until then, here are my rules: 

MOW TO l=-|_AV TME SAME 


Plug in joysticks into ports 1 and 2. Each Player moves 
his character and tries to score points. One point is scored 
each time you "gobble” one of the two "Energizer Pellets" 
that will appear from time to time. Five points are scored 
if you gobble your opponent. This is done by first touching 
the blue recharge zone in the center of the maze. Your 
character will change color and may score by touching the 
other Player, If the other Player touches the recharge zone, 
then he can get you and your color changes back to normal. 


I started the scores out at three each just to point 
OUT that everything doesn’t have to begin at zero. The logic 
to the game is to balance your moves between going for easy 
single pointers and the big score of five points! 


That's true, but think of this exciting fact. All of the 
basics techniques of real arcade games are Included In this 
I ITtIe game. The only Improvements needed are your own Ideas 
and SPEED. Arcade games are written In machine language 
which accounts for the speed. The Ideas are up to you I 

Notice the way the characters move. They are slow, yet I 
am moving them with machine language routines (these will be 
explained later). What slows them down Is the Basic language 
needed to call them. Also, notice what happens when the 
characters touch the walls of the maze. After you have a 
real Idea of what features are In the game, run example 5.3 
and weM I begin the lesson. 



This example Is so simple to understand that my daughter 
even helped me write It. The basic Idea I already mentioned 
above, but I'll repeat myself Just this once (or twice). The 
stuff you see on the screen that Is not a Player or Missile 
Is called PLAYFIELD. Playflelds are created by plotting 
points using the PLOT and DRAWTO commands, or by direct 
POKElng of data Into the memory area that Is displayed on 
the screen. You should already be familiar with PLOT and 
DRAWTO from your BASIC manual. If not, read about them In 
the manual and then come back. 


PRESS 1 on your keyboard and plug In a Joystick Into port 
#1 . Move the Joystick around to draw color 1 on the screen. 

Now PRESS 2 and draw with color 2. PRESS 3 and do the same. 
Finally PRESS 0 and draw with color 0. Notice that color 0 
seems to erase rather than draw, but I assure you It Is 
drawing. Think about It. Color 0 draws with the background 
color so when It Is plotted any other color, of course, lt*s 
changed (I know this was obvious to some of you). 


I wanted to show you the playflelds. Playfleld 0 Is the 
background color; Playfleld 1 Is whatever Is drawn with 
color 1, etc. Page 53 of your Basic manual shows which 
Graphics modes allow which playflelds. Although very simple, 
this example Is Important for you since you must know which 
playfleld you are testing for when you use the collision 
registers discussed later. 


9 


A NOTE ON COLORS - 

Throughout all of these examples. If you don’t like the 
colors being used, please change them to match your TV. I 
have several sets that ail show the colors differently, so 
some of these examples may look strange to you. Here Is how 
to change the colors: 


The correct value to POKE Is: 
COLOR * 16 + LUMINANCE 


where color Is a 0 to 15 and luminance Is from 0 to 14, In 
even numbers. 

Look within any example you want to change until you find 
the correct number being POKEd and place your color choice 
In the POKE statement. 



You probably know that any program, whether for a game or 
a business application, will need a background. The 
exception Is a text-only program which would seldom need the 
use of PMG. 

Let’s say you want a space game with mountains, enemy 
bases, a few ships on the ground to shoot at, and maybe even 
some trees. These need to be plotted on the screen before 
the game can begin. The normal method Is to use graph paper 
ana hand calculate each point to be plotted. WOW! That Is 
the hard way! Feeling Inspired, I thought I would whip up a 
little editor to help you. Here’s how to use It. 


1“ EE 


Because this program requires 32K to run. It Is the next 
to last program on the cassettes. For disk users. It Is In 
the same order we have been discussing. 
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When the program has been loaded, disk users may press 
”L” and then ”D” to bring In a previously saved drawing as a 
test. You will notice a flashing dot, or cursor, on the 
screen. This Is the point that Is being drawn as you move 
It. You can choose between playflelds 0 , 1, 2 or 3. First, 
find out how many Playflelds you are allowed In the Graphics 
mode you want to use. For example. If your program uses 
Graphics 5, you have all four colors to work with; In 
Graphics 6 you only have two. Press the number of the 
Playfleld color and use the cursor keysCdon’t press CTRL) 
to move the cursor. Remember, to erase, you plot In the 
background, color 0. Draw out a building or spaceship. 

When done, the editor allows you save the shape two ways: 

To save the shapes for future use and modifications you 
may press ”S” and then ”T” or **D” for tape or disk. 

When done, the editor allows you save the shape two ways: 

To save the shapes for future use and modifications you 
may press and then ”T” or "D" for tape or disk. 

Tape users be sure and record the location on the tape 
where the program starts so that you may find the data 
again. Disk users will always find the data saved under the 
same name on the disk, PFDATA, so If you want to keep the 
shapes use the rename command, ”E”, FROM DOS, to name the 
data something more meaningful. 

To use the shapes In your program, you will need a 
simple subroutine. Look In the program code for this example 
to see a very sophisticated way to handle the data using 
strings. Go ahead and copy parts of It for your own use. 

Before presenting the code, let me remind you what we are 
doing. Each color of your shape needs to be plotted 
separately. Also, you will probably want to plot the shape, 
for example, a tree with some ground arOund It, at several 
points In the background. Finally, many other shapes like 
men, spaceships, and planets, must also be plotted. 

To get the data for your shape. Just press SELECT and 
wait for 10 seconds. The text area of the screen will start 
presenting DATA statements that are the points to plot. The 
upper left corner of the square that limits your shape. If 
colored, would be 1,1. These numbers represent first an X 
value, and then a Y value of a standard grid system the 
ATARI normally uses for Graphics. To see all of the data for 
each color, press START each time the data stops. If you 
have more than 199 points In your shape of any one color, 
the program will say "TOO MUCH DATA" . I could only fit In 
that many points, so go back and change a few to a different 
color. It won’t happen for most shapes. 

The numbers of the DATA statements should be changed to 
fit within your program. You may want trees to always start 
at 5000; buildings at 6000, etc. 



Here is a sample program to use with the Playfield Editor 


400 

410 

420 

430 

440 

500 

510 

600 

610 

700 

710 

800 

1000 

► 1010 
1020 
1030 
5000 
5010 

5020 

6000 

6010 

7000 

7010 

7020 

7030 

7040 


GRAPHICS 5 

SETCOLOR 0,12,4 

SETCOLUR 1,3,2 

SETCOLOR 2,13, 12 

SETCOLOR 3,8,6 

REM^^^^^DRAW THE TREE 

COLOR 1: X=50: Y=24; GOSUB 1000 

REM^^**DRAW THE TRUNK 

COLOR 2: X=50: Y=24;G0SUB 1000 

REM***DRAW THE SUN AND RAYS 

COLOR 3; X=30: Y=15: GOSUB 1000 

END 

rem***plot routine 

FOR I = 1 TO 80 

READ A,B: IF A =999 THEN RETURN 
PLOT A+X,B+Y: NEXT I 
REM*^^*DATA FOR TREE 

DATA 2, 2, 3,3, 4, 4, 5, 5, 6, 6, 7,7, 8, 8,9,9, 8, 9, 7,9, 6, 

9,5,9,4,9,3,9,2,9,1,9,0,9 
DATA -1,9,-2,9,-3,9,-4,9,-5,9,-4,8,-3,7,-2,6,-1, 

■) n 4 1 5 QQO 999 
REM*»»DATa'for'TREE TRUNK 

DATA 2,10,3,10,2,11,3,11,2,12,3,12,999,999 
REM»*»DATA FOR SUN AND RAYS 

DATA 0,0,1,-1,2,-2,3,-3,4,-4,4,-5,4,-6,3,-7,2,-8,1,-9 
DATA 0,-10,-1,-10,-2,-10,-3,-9,-4,-8,-5,-7,-6,-6, 

-5,-6,-4,-5,-3,-4,-2,-3,-1,-2,0,-1,0 
DATA 3,1,4,2,5,3,6,4,7,5,8,6,9,7,10,8,5,-1,6,0,7,1,8,2 
DATA 6,-3,7,-2,8,-1,9,0,10,1,11,2,12,3,13,4,6,-6,7,-5, 
8,-4,9,-3,0,2, 1,3,2,4,3,5,999, 999 
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E:XAMF»L-E S-55 
COLORS 

r'>4 0 “i“EE:: 


Tape users may have this program cone on the screen 
looking very strange. Just press reset and type RUN to 
correct the screen 



We talked about how to change the colors of the 
playfleld (708 to 712) a few pages ago. The following 
utility will allow you to pick the colors directly without 
calculating the number to POKE. The POKEs listed, however, 
are for the Player colors which live In different locations 
(704 to 707 + 711). The color value to place Into any of the 
locations still uses the formula COLOR * 16 t LUMINANCE. 
Beyond this, the real purpose of this example Is to 
Introduce you to the Players and Missiles. 


Look at the stripes of color on the screen. Each one Is 
half a Player. The bottom half Is "turned off” so that you 
can see the color Information. 
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Good question! The stripes are only being used to best show 
the colors of the Players as you change them (I Ml tell you 
how In a moment). You can pick which of the eight pixels 
(I ITtIe squares of color) across each stripe will be 
colored. In the next example we will select certain pixels 
and create a useful shape. For now the top half of each 
Player ana Missile Is turned on (all 8 pixels colored) and 
the bottom half Is turned off(all eight pixels POKEd with 
0»s) . 


Are you wondering which Player Is which? Player 0 Is on 
the far left and Player 3 Is on the right. On the far right 
Is the corresponding Missiles 0 to 3 that work with each 
Player. I know that calling the first Player by **#0" Is 
confusing, but It Is required by the ATARI hardware and 
software. Soon youMI see how to place these shapes 
anywhere on the screen you wish. 

How To Use This Example 


Plug a joystick Into port 1. As soon as you move your 
Joystick an ***** will appear. Place the asterick over any of 
the Players. Hold the trigger button down and move the 
Joystick up to Increase the color value, or down to decrease 
It. Notice that the numbers you POKE are the same for any 
given color. This means If you find a red that you like with 
a value of 45, you can POKE 45 Into any of the color 
registers from 704 to 712 and get red for that Player, 
Missile, or PI ayfIe I d . 

When you have one Player color just like you want It, 
move the asterick to another Player and change It’s color, 
too. After all four Players are done, you can set the 
background color by moving the asterick to the far right 
side and pressing the trigger. Notice how the background 
color changes the appearance of the player’s colors. Now 
use these color values In POKE statements within your own 
programs. 

A few of you by now have tried to change the colors of 
the Missiles. We have not yet mentioned any color registers 
for the Missiles. That’s because there aren’t any! Each 
Missile takes on the color of the Player with the same 
number. Here Is a review of the colors and registers: 


REGISTER 

*******^(*** 


USED FOR 


704 

P1ayer 

705 

P1ayer 

706 

P1ayer 

707 

P1ayer 

711 

P1ayer 


0 and Missile 0 

1 and Missile 1 

2 and Missile 2 

3 and Missile 3 

4 (all Missiles together) 





What? Player 4? Yes, you must know by now that the ATARI 
Is full of suprises. It turns out that the Missiles can be 
combined together Into a 5th Player (#4). We will come back 
to how this Is done later. For now, press SELECT. The 
Missiles will now come together and take on the color POKEd 
Into 711. To use the Color Editor on Player 4, just move 
the asterick to It and use the trigger. Pressing SELECT 
again would toggle the 5th Player back to Missiles. This 
would be a good utility to use whenever you need to choose a 
color. 


DIFFEREKCE ^ETWEE'N A ^ 
r.o'T’Ted shape anp a PLAVEP 

MISSILE IS ASTONISMiNe-. -- * 



To solve this "Great Mystery" use a Joystick In Port 1 
to move each shape. The Player moves WITHOUT PRESSING the 
TRIGGER. The playfleld shape moves by PRESSING the TRIGGER. 

I have to admit that I cheated In this example. The 
Player Is being moved with a small machine language utility. 
However, you will soon see that even BASIC can move a Player 
pretty fast vertically and Immediately horizontally. 

An Interesting experiment to do with this example Is to 
change the color In the program of the Player (find a POKE 
704,with a number after It) and then move the Player exactly 
on top of the plotted shape. If you move two plotted shapes 
over each other, and then move them away, you will have to 
redraw them both to remove the holes left In their shapes! 
The effect Is even better If you break the program and 
change the color of one of the Robots. Aren*t Players 
great? 

e:xamf>le: 

CREiOfcT IIMO YEFCS 

Press OPTION to get to the next example, 5.7. This will 
begin the technical part of this Tutorial. 


First of all, notice that the last picture Is still on 
the screen. Do you know how this happened? It*s very simple. 
With playflelds, when you plot a background on the screen 
they stay on until erased with either new plotted data, or 
usually Just another Graphics call. You loaded In the next 
program while a playfleld —the Robot— was still on the 
screen, so It Is still there when this example starts to 
run. This process Is similar to adding 32 to a graphics call 
as explained In the BASIC manual. 


You can create your backgrounds with one program and 
then have the main loop of your program load in separately. 
This allows large programs to fit into smaller memory sizes. 
Players will stay on the screen, too. 


Again, plug In 
Joystick #1. You can 
move the shape on the 
screen In all directions. 
Including d I agona My. 
This routine Is ver y 
Important to you since It 
will teach all of the 
following basics: 



IMPORTANT STUFF TO LEARN 
FROM THIS EXAMPLE 



1) How to create a Player shape 

2) How to move that shape up and down (vertically) 

3) How to move It sideways (horizontally) 

This example can be copied Into ANY program you want and 
just modified In a few places to get a Player moving around 
on your own design of a game or other application. It should 
be saved to a separate Tape or Disk and even renamed as a 
utility for Disk users. 

10 GOTO 140 
20 REM 

30 REM ****** MAIN LOOP ********** 

40 REM 

50 ST=STICK(0) 

60 X = X + (ST = 6)+(ST = 7)+(ST = 5)-(ST = 9)-(ST=10)-(ST=1 1 ) 

70 Y = Y + (ST=13)+(ST = 9)+(ST = 5)-(ST = 6)-(ST=10)-(ST=1 4) 

80 GOSUb 330 

85 IF PEEK(532/9)=3 THEN POKE 764,12:RUN "D;EX5.8" 

90 IF PADDLE(0)^228 THEN 110 
100 X=PADDLE(0) 

110 POKE 53248,X 
120 GOTO 50 
130 REM 

140 REM PMB=PLAYER MISSILE BASE ADDRESS IN PAGES 
150 REM (256 BYTES PER PAGE) 

160 POKE 704,40 

The example starts out skipping to line 140 to do some 
standard setups that will always be required. Line 160 you 
should recognize as setting the color of Player 0 , which we 
“■'I use for the shape (Spaceship?). Line 170 to 190 look 
like this: 


170 PMB=PEEK(106)-16 
180 POKE 54279,PMB 
190 PMBASE=PMB*256 


These lines reserve space In memory for Player and Missile 
shapes to be stored. This topic alone could take pages to 

explain, but I will give you only enough Information to make 
It work- _ 
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Players & Missiles are created on the ATARI by something 
called DMA. DMA means Direct Memory Access. All the big 
computers have It. Apples don’tl This process simply means 
that If you have "turned on" the DMA, the computer will take 
whatever shapes It finds at a place In memory starting with 
PMBASE and put them on the screen. They will be located 
horizontally (X direction) by the values stored In their 
horizontal registers (53248 to 53255). Their size In the X 
direction Is controlled by values stored In size registers 
(53256 to 53260). Their size In the Y direction Is 
controlled by two factors. First Is how many pixels you have 
turned on for their shape. Second, Players may be created 
where each number In memory Is put on the screen as either 
one pixel (single line resolution) or two (double line 
resolution). Their location on the screen In the Y direction 
Is simply controlled by where In the stripe you turn on 
pixels. 

WOW... I»M Tired 


That was a loti There’s even more to come, so take a 
break If you need to. 



Back to lines 170 to 190. Line 170 takes the value In 
location 106, which Is the location of the top of user 
memory (given In number of 256 bytes pages), and subtracts a 
certain amount of pages. This number Is then POKEd Into 
54279. That will tell the computer where the Player data 
starts. Finally, line 190 takes PMB In number of pages and 
co^nverts the value to a regular memory location, PMBASE. We 
will use this number a lot. The number I subtracted, 16, 
will change depending on the Graphics mode you are using. 
Choosing the amount to subtract is explained In EX5.9. 




210 X=125:Y=100:YSAVE=100 
220 POKE 53256,0 


Next, In line 200, we POKE 53277 with a 3. This memory 
location Is called GRACTL. Poke It with a 1 for Missiles 
only. Poke with a 3 for Players and Missiles. 

In line 210 are the Initial X and Y positions where you 
want the Player on the screen. In 220, the size of Player 0 
Is set to normal, which Is 0. If you had Just turned on the 
machine, 53256 would have contained 0 anyway, but since we 
are running many programs one after another, this made sure 
the value was correct. The choices you have for the size 
are; 


Poke With For 


0 


Normal size 


1 


DoubIe size 


3 


Quadrup Ie size 


Here are the registers available for controlling 
PIayer/MIssI Ie size. POKE wth the appropriate values from 
the previous table. 


RESISTER 


PARAMETER 


53256 

53257 

53258 

53259 

53260 


size. Player 0 
size. Player 1 
size. Player 2 
size. Player 3 
size of all missies 


To determine Missile size, youMI have to do a little 
calculating, but nothing too complicated. Just pick the 
desired size for each Missile from the chart below, then add 
up the numbers for all four (or however many you’re using) 
and POKE the total Into memory location 53260. 

For example. If you want a normal Missile 0, a double 
Missile 1, a quadruple Missile 2, and a double Missile 3, 
you would POKE 0t4t48t64=116. 


MISSILE # 

NORMAL 

DOUBLE 

QUAD 





0 

0 

1 

3 

1 

0 

4 

12 

2 

0 

16 

48 

3 

0 

64 

192 
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230 FOR I=PMBASE+1024 TO PMBASE+1280:POKE l,0:NEXT I 


Line 230 POKEs 0*s Into the area where the data for the 
Player must go. This will act to clear out the Players 
stripe first. This may not seem necessary to you. For this 
reason, some of the later examples will actually erase their 
Player areas while you are watching. You will see the Junk 
being erased. This statement takes a few seconds to do, and 
thus delays the beginning of any program that uses it. The 
best way to speed it up is to put it at the very front of 
your programs. This is demonstrated In later examples. For 
this example we only had to clear out memory between 
Pmbase + 1024 and Pmbase-H 280 . Why? To explain we need a chart 
of what memory looks like: 


SINGLE LINE RESOLUTION 


PEEK(106) 


Pmb ase+2048_^ 

Pmbase + 17 92_^ 

Pmbase + 1536_^ 

Pmbase + l 280_^ 

Pmbase + 1 024 
Pmbase+76 8 _^ 

Pmbase __ ^ 

(POKE into 
54279) 


Top of Memory 


Screen Data Area 
Depends on Graphics Mode 


UNUSED 


P I ayer 3 


PIayer 2 


PIayer 1 



P 1 ayer 0 


M3 

M2 

Ml 

MO 

768 Unused 

Memory Locations 

The 

Rest 

of Memory 

and Your Program 


] 


} 


694 to 8112 Memory 
Locations 


8 bits wide - 
Each bit Iights up 
one TV pixel. 


2 bits wide each 
Missile or use 
all 4 as a PIayer 


Look at the chart above marked Single Line Resolution. 
Starting at the place marked top of memory, we move down by 
a certain number of pages subtracted from the value in 106. 
This places us at the BOTTOM of the chart. This calculation 
was done In lines 170 to 190. Again, the amount to subtract 
will be explained in EX5.9. 
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Now that we have placed Pmbase, go back up in memory to 
Pmbaset1024. The next 256 bytes of memory are the stripe 
that holds Player 0. If any of these bytes of memory are not 
0, and if the setup POKEs have been made to turn on DMA, 
then those non 0 bytes will light up on the screen with the 
color values stored In 704. 

To move the shape up or down the screen, you just POKE 
non 0 bytes up or down the stripe of memory. Let's say that 
you place Pmbase at 30000 In your memory. Any non 0 bytes 
at Pmbasetl030(30000tl030, or 31030) will appear near the 
top of the screen and If those same numbers are POKEd Into 
Pmbaset 1200, they will appear near the bottom of the 
screen. 

Continuing with this logic should make It clear what 
happens If you POKE numbers Into Pmbaset 1400. You would now 
be turning on a shape In Player 1 that would appear on the 
screen If the "setup POKEs” were done. Let's finish 
discussing the setup procedure. 


Lines 240 to 300 POKE the shape Into memory, just as we 
were talking about above. Understanding lines 250 to 300 

will be a real key for you. Here Is what they look like; 

240 RESTORE 210:CNT=0 

250 FOR l=PMBASEt1024tY TO PMBASEt1280 

260 READ B:IF B=0 THEN 310 

270 CNT=CNTt1 

280 POKE l,B 

290 NEXT I 

300 DATA 8,60,126,195,126,60,24,126,165,0,0 

The shape Is poked Into memory with an offset of ”Y”. This 
says to place the shape Y units down the screen. If Y=0 then 
the shape will be at the top of the screen. A value of Y=252 
puts the shape at the very bottom since the shape has eight 
numbers that must fit Into the 256 byte long stripe of 
memory. in a few lines we will simply calculate where we 
want the shape on the screen and use this routine to POKE It 
Into the right place. 
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The last major hurdle Is the way the data Is calculated. 
Here Is another figure to help you visualize the shape: 

PLAYER 0 


Top of TV Screen 


256 

Number 

Stripe 


Pmbase4'1024 


Pmbase+1024+Y 



Bottom of TV screen 


Add 32 
Add 64 
Add 128 


4+8+16=28 
2+4+8+16+32=62 
1+2+4+16+32+64=119 
1+2+4+8+16+32+64=127 
2+4+8+16+32+64=126 
4+8+16+32+64=124 
8+16+32+64=120 
4+8+16+32+64=124 
2+4+8+16+32+64=126 
1+2+4+8+16+32+64=127 
2+4+8+16+32+64=126 
2+4+8+16+32=62 
4+8+16=28 


This Shape 
Has 13 Numbers 


To create your own shape, you Just fill In the boxes 
you want for the shape. Then to get the "TOTAL”, you just go 
across each row and add up the value for any box that Is 
filled In. When you poke these numbers Into memory, your 
shape appears on the screeni 


Back to the program code. Line 310 Is what finally turns 
on the player. The correct value here Is obtained by adding 
up the options you want from the following: 

FOR add 


DMACTL (559) 


Wide pi ay field . 

Standard PI ay fIe I d ... 

Narrow Playfleld . 

Turn on Missile DMA .. 
Turn on Player DMA ... 
Double Line Resolution 
Single Line Resolution 
Turn on Main DMA . 


3 

2 Choose 1 
1 

4 
8 
0 

1 6 Choose 
32 


On I y 


Only 
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In this case we want Standard playfleld (2) + Missile 
(4) and Player (8) DMA plus the Main DMA (32) and Single 
line Resolution (16) for a total of 2+4+8+32+16=62. This Is 
why we poke 559,62. 


That ends the Setup 


You should be able to use this same setup code for most 
PMG programs you do. Just make the few changes required by 
things like resolution and playfleld size. Note - single and 
double line resolution will be discussed In example 5.10 
coming up soon. 


The program now branches to the main program loop at 
line 50, which reads joystick 0. Lines 60 and 70 Increment X 
& Y from their Initial positions set In line 210. The only 
thing left for the program to do Is move In the X and Y 
directions. The X direction Is easy. The ATARI has built In 
position registers for the X direction. In line 110 we just 
poke the new X value Into that memory location, 53248. 


Here are the X direction registers 


REGISTER # MISSILE/PLAYER 


53248 PO 

53249 PI 

53250 P2 

53251 P3 

53252 MO 

53253 Ml 

53254 M2 

53255 M3 


To move In the Y direction we have to do something similar 
+0 the way the playfleld Robot was moved In EX5.6. 
Fortunately, we don't have to move as many bytes of memory 
around* That robot had almost 200 data points! Moving our 
player Is as simple as poking In eight numbers Into memory. 

310 POKE 559,62 
320 GOTO 50 
330 REM 

340 REM UP/DOWN MOVE ******* 

350 IF YSAVE=Y THEN RETURN 
360 IF YSAVE<Y THEN 430 
370 RESTORE 210 
380 FOR 1=1 TO CNT 
390 READ B 

400 POKE PMBASE+1024+Y+I,B 
410 NEXT I 

420 YSAVE=Y:P0KE PMBASE+1024+Y+CNT+1,0:RETURN 
430 RESTORE 210 
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440 FOR 1=1 TO CNT 
450 READ B 

460 POKE PMBASE+1024+Y+I-1,B 
470 NEXT I 

480 YSAVE=Y:POKE PMBASE+1024+Y-1,0:RETURN 

Look at lines 340 to 480. First, In 350, I compare the 
current value of Y to the last. If It Is the same, we don't 
waste our time and Just return. Line 360 says, "If Y Is now 
bigger than last time, go to the move up In memory routine 
at 430, otherwise move down". Remember, as Y Increases In 
memory, the shape appears to go down the screen. This comes 
from the way the ATARI does It's coordinate system and Is 
explained on page 47 of your Basic manual. 


Both the routine to move up, and the one to move down, 
are similar to the original one we used to POKE the shape 
Into memory. All we are doing Is POKEIng the same shape down 
or up by one byte In memory. 



MOM ME AF%E CBETT X NC3 MOT! 



I MF»OI=tT#:MMT l=>0 IIMT I 

0 

When you move the shape you repoke 7 of the 8 numbers 
that are currently In memory and poke In one number In a new 
location. That last number Is not changed because you have 
moved by one byte. That Is why the 0 Is poked Into that 
remaining location In line 420 or 480. Were the 0 omitted, a 
trail of unchanged bytes would be left on the screen, 
leaving something like this: 



If you are lost by all this there Is only one way to figure 
It out. Stop the lesson now, break the program, and start 
making small changes to where and what numbers are poked 
Into memory. Soon you will say to yourself, ”That*s what The 
(old/not so old) PROFESSOR was trying to say! 



THAT’S IT? 


You now have most of the basics to place a player on the 
screen and move It around. The earlier playfleld editor 
discussed how to create the background for your program. Now 
all we need are the small details that tie all of this 
together. 


HEY! WHAT ABOUT THE PADDLES? 



Oh yes, I forgot to tell you why the move In the X 
direction was so slow. The Joysticks we are using, combined 
with the program code, only allow X to change by one value 
at a time. Paddles, on the other hand, can Instantly change 
the value they return from 0 to 228. Plug In a paddle 
controller. If you have one, and now try moving the shape 
across the screen. It will be Instantaneous! 
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EXAMI=>L.E 


This simple example takes the same basic routine as In 5.7, 
but starts to make It look like a game. Finish It If you*d 
like. It’s good practice. There are three things you should 
learn from this example. 

First, notice the stripe of randomly flickering ”junk” 
on the screen when the program first starts. This Is caused 
by only partly turning on the DMA as discussed above. As 
soon as all the setup Is complete, the exact shape appears. 


Second, look at the program list and see the way the program 
Is structured. When you write your own codes, I suggest you 
do something like this. The program Just goes to several 
subroutines that : 

1) Draw the mountains 

2) Draw the stars 

3) Set up Player 0 as shown In the utility above 

4) Main loop routine for the movement and/or 

scorIng 

Notice that I use sound In the loop. It’s easy to do If 
you spend a little time In practice. This simple 

structuring Is used In many arcade-style games. 

Third, I’ll show you one of the two machine language 
utilities within the program. Both are short and can easily 
be transferred to you own programs. This one Is used to 
move only Player 0. It will read Joystick 0 and move the 
data In the Player 0 stripe accordingly. You must use 
single line resolution Players, as we have been doing so 
far. (That means the shape Is at PMBASE t1024 to PMBASE 

+1279) Copy the needed lines to a separate file using the 
LIST command. Then you could enter It as needed. Don’t’ 
forget to delete the other lines of the program first. The 
lines you need to keep are just 40,90, and 130. 

Heres the routine: 


DXM IESC605 


xe.© ©"-OSR tittPR CE;S3 i , STXCK o „ 
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When you run this example notice our old friend the 
Robot. He’s back! However, as you move him around (using 
the same machine language routine as the last example), 
there’s some ’junk’ on the screen. 


The time has come, my friend, to explain how to position 
the PI ayer/M I ss I I e data area within memory. Look at the 
program listing for example 5.9. Do you remember how we 
obtained the value for PMBASE? It worked like this: 


100 PMBASE = (PEEK(106)-16)*256 


On page 45 of the BASIC manual, you’ll see a chart 
showing the amount of RAM (memory) needed for each graphics 
mode. As the next figure shows, you don’t want the data for 
the Players and Missiles overlapping the data placed on the 
screen. Even worse would be to write over the DISPLAY LIST. 
That Is what happened to tape users with example 5.5. 

When they reran the program by pressing RESET, the 
Operating System fixed the display list. In this 
example,look at the Player data being moved by the machine 
language program within the Player stripe. See If you can 
understand the term ’wraparound’ by moving the Player up 
until It comes back from the bottom. This will also work 
sideways. The data that Is being written to tne screen area 
will also ’wraparound’. 
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In example 5.5, when I explained the method, I said that 
the number 16 changes depending on your program. Let’s 
discuss why. The listing you are looking at will only use 
16 as the memory amount to subtract because the Graphics 
mode being used requires IK or less of memory. As another 
example, 5.8 POKEs memory back 40 pages because Graphics 8 
requires more memory. 

Here’s a drawing to help our discussion: 





OOP’S WRONG DRAWING 


CONFLICTS 

Between 

PLAYER MISSILE DATA AREA 
and 

SCREEN DATA AREA?? 


SCREEN DATA AREA 
256 to 8112 
bytes 


PLAYER DATA AREA 
Ik or 2k 



CONFLICT! 


Remainder 
of Memor v 


Junk on Screen! 
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The easy way to avoid putting Player data where it doesn't belong is to 
use the following chart. Single line resolution players always must start on 
a "IK boundary." This simply means subtract from the value in 106 either 8 
pages, or 16, 24, 32, etc. Remember, a PAGE is 256 bytes (1/4K). When we 
discuss double line resolution players (soon, soon), you must start the data 
on a IK boundary, so subtract 4, 8, 12, 16, etc. 


GRAPHICS MODE 

APPROX. # MEMORY LOCATIONS USED 

SUBTRACT THIS # 
FROM LOCATION 106 

0 

992 

16 < 8 ) 

1 

674 

16 ( 8 ) 

2 

424 

16 ( 8 ) 

3 

434 

16 ( 8 ) 

4 

694 

16 ( 8 ) 

5 

1174 

16 < 8 ) 

6 

2174 

16 < 12 ) 

7 

4190 

24 ( 20 ) 

8 

8112 

40 ( 36 ) 

9 

8112 

40 ( 36 ) 

10 

8112 ! 

40 ( 36 ) 

11 

8112 

40 ( 36 ) 


nr«^e a bird 

I T - S A RL. ANE 

S. . . double liime 

RESOLUnr I OIM 
EXAMRLE =.lO 

This simple example Introduces you to the SQUIGILY 
MONSTER, It will show Itself In two sizes. The smaller size 
Is called single line resolution. This Is the way we have 
previously set up our Players. Simply put, each number In 
the data area for the Player Is placed on the screen as one 
line also. The data area has 256 bytes available, which as 
you saw In the Color Changing example, more than covers the 
screen. If you look closely at the screen you can see the 
Individual pixels. 


The other way you can set up your Players 
Is called double I Ine ■ resoIutI on. This uses 
per Player; meaning, to fill the screen, the 
place TWO lines on the screen for each number 
area. This makes the shape appear thicker. 


and Missiles 
only 128 bytes 
computer will 
In Its data 


Press the SELECT button for the single line Player and 
the START button for double line. 
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Double line Players are set up similar to single line, 
but with these differences: 


1) Instead of adding 16 to the total value to POKE Into 
559, add 0 (see previous chart). This tells the computer 
where to look for the data for each Player and Missile. This 
example switches between the two resolutions with just this 
one POKE. 


2) Instead of POKEIng the shape of the Players Into 
PMBASEt768 to PMBASE +2048 as the above figure showed, you 
place the data Into PMBASE+384 to PMBASE+1024. This means 
that we have to look at .... ANOTHER FIGURE: 


DOUBLE LINE RESOLUTION 
Top of Memory 



The decision on which resolution to use depends on how 
smaI I you want the pixels to be In your figure and how much 
memory you can afford to use for the shape data. I have 
given you several of each type In these examples, so It’s up 
to you. Have fun! 
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There Isn't too much more to learn before we can discuss the 
game. Next, we'll animate the little Pacman(tm) type shape 
(note; we refer to a general type of shape and are not trying to 
Infringe on others rights, end of legal talk). Run example 5.11. 
You'll see the memory area for the shape cleared out, then the 
shape appears. It doesn't look much like a Pacman(tm)? No mouth? 
Push the JoystIckI 


The shape looks better now that It Is moving. I could have 
used three or four shapes to open and close the mouth, but two 
shapes Is simple to explain. If you add another shape with the 
mouth Just slightly open, you'll see smoother action. To see the 
two shapes as they change, just give a series of quick pushes on 
the stick. What you are seeing Is two Players, but only one at a 
time. Let's see how this Is done. 


10 FOR 1=1 TO 8:P0KE 53247+I,0;NEXT l:G0T0 240 

20 FOR l=PMBASE+1024 TO PMBASE+1792:POKE l,0:NEXT liRETURN 

30 REM *****PLAYER SETUP ***** 

40 GRAPHICS 7;D=20:E=50:P0KE 710,0;P0KE 712,0:P0KE 704,41: 

POKE 706,41:P0KE 559,62 

45 COLOR 2;PL0T 1,57;DRAWT0 159,57;PL0T 1,65;DRAWT0 159,65 
50 A=PEEK(106)-32:P0KE 54279,A:P0KE 204,A+4:POKE 203,0: 
PMBASE=A*256 

60 POKE 53277,3:X=150:P0KE 205,120:P0KE 53256,0:P0KE 53250,150 
POKE 53258,0 


70 GOSUB 20 
80 RESTORE 110:Y=150 
90 FOR I=PMBASE+1024+Y TO 
POKE l,B:NEXT I 


PMBASE+1209;READ B:IF B<>0 THEN 
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100 REM ***** DATA FOR PACMANl ***** 

110 DATA 28,62,119,127,254,252,248,252,254,127,126,62,28,0,0 
120 RESTORE 150 

130 FOR l=PMBASE+1536+Y TO PMBASE+1792:READ B:IF B<>0 THEN 
POKE l,B;NEXT I 

140 REM ***** DATA FOR PACMAN2 ****** 

150 DATA 28,62,118,255,255,255,255,255,126,126,62,28,0,0,0,0 

160 POKE 559,62 
170 REM 

1«u REM ******MAIN loop ****** 

190 REM 

210 ST=STICK(0):S=PEEK(53279) 

220 IF S=3 THEN POKE 764,12:RUN »D;EX5.12" 

222 IF ST=15 THEN 210 

225 X=X + (ST = 7)-(ST=11 ):POKE 53248,X:POKE 53250,0:FOR J = 1 TO 50: 
NEXT J 

226 POKE 53250,X:POKE 53248,0 
230 GOTO 210 

240 GRAPHICS 17:P0KE 712,69:P0KE 710,19 
250 ? #6;"ANIMATI0N OF SHAPES »* 

260 ? #6;” IS AS SIMPLE AS " 

270 ? #6;"SWITCHING BETWEEN ” 

280 ? #6;” TWO PLAYERS AS YOU " 

290 ? #6;»*M0VE AROUND.use ” 

300 ? #6;"Y0UR JOYSTICK TO SEE” 

310 ? #6;”THE pacman(TM) MOVEI” 

320 FOR 1=1 TO 3000:NEXT I:GOTO 40 
330 POKE 764,255 

Look at the program code for example 5.11. Notice In line 
50 the memory setback is 32, not 16. This is the amount required 
when using Graphics mode 7. In line 60 POKEs, are made to both 
the horizontal location and size of Player 2. Yes, Player 2! You 
don't have to use the Players in any particular order. Lines 120 
to 150 Just POKE in the data for a second shape into the correct 
area for Player 2. In line 225, POKEs are made to place Player 0 
at X and Player 2 at 0, which is off screen. Finally, at line 
226 Player 0 Is moved off screen and Player 2 is placed at X. 
There is a delay on line 225 to allow you to see the "switching” 
of shapes. 


Does that seem hard? All you have to do to create additional 
PIayers Is : 

1) Poke into the correct memory area the data for their 

shape 

2) Poke the size you want into the size location in memory 
(opt I ona I,sinee 0 Is a default If you forget) 

3) Poke the horizontal location (X) into the horizontal 
memory location. 

4) Have fun I 
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To animate a shape. Just alternate two or more shapes at the 
same spot on the screen. The different shapes will seem to 
blend Into a single, animated shapel 


A note on animation Is In order. Remember the Robot 
example where I asked "Which Is the Player?”. I hope you can 
now see the power of using Players for your shapes. To plot 
and erase this shape from BASIC would be very,very slow! 


f=>R Z OR X ~r Y AND OOL-L.. Z S X ONO 
EXAMPL-E S. X2 



These two topics were saved for last. They’re not 
JIffIcult subjects, I just wanted you to get a lot of 
experience first with the basics. Example 5.12 takes the 
beginnings of a game that we did In example 5.11, and adds 
collision with some energy pellets In order to allow the 
creature to "eat” the pellets. When It crosses over the 
"walls” In the tunnel, the shape will seem to be In front of 
the walls. At the end of the tunnel, the shape will be 
Inside, or behind the wall because I set the priorities so 
some colors act differently than others. Here’s how I did 
Itl 


Most of this program Is the same as the other examples. 
One of the nicest things about using Players ana Missiles is 
writing a program, and then making only slight changes to 
use It for a completely different purpose. 


Line 10 POKES all of the horizontal location registers 
to 0. This Is not used In this program, but makes sure that 
all previous Players are off screen. Remember, just because 
we loaded In a new program, doesn’t mean that old Players 
will disappear. They stay there until removed! This can be 
useful In programs that have multiple parts to them. 



10 FOR 1=1 TO 8:P0KE 53247+I,0:NEXT l:GOTO 270 

20 FOR 1=PMBASE+1024 TO PMBASE+1536:POKE l,0:NEXT l;RETURN 

30 REM *****PLAYER SETUP ***** 

40 GRAPHICS 7:P0KE 710,0:POKE 712,69:P0KE 704,41:POKE 706,41: 
POKE 559,62 

45 POKE 708,103:P0KE 752,1:P0KE 709,139;POKE 710,100 
47 COLOR 1:F0R X=20 TO 150 STEP 30:PLOT X,61:PL0T X+1,61;NEXT X 
50 COLOR 2:PL0T 1,57:DRAWT0 159,57:DRAWTO 159,66:DRAWTO 1,66: 
DRAWTO 1,57 

52 PLOT 157,57:DRAWT0 157,66:PL0T 158,57:DRAWTO 158,66 

55 COLOR 3:F0R J=1 TO 4:F0R K=1 TO 5 

56 T=K+J*30 

57 PLOT T,57:DRAWT0 T,66:NEXT K:NEXT J 

Lines 47 to 57 plot three different parts to the 
background. The first part Is the "energy pel lets", le. small 
dots, that the Pacman(tm) will "eat". These are plotted In 
Color 1 (location 708). Next, lines 50 & 52 draw out the 

rectangular lines that our Imagination will call walls of a 
Pacman(tm) tunnel. The walls are drawn In Color 2. Lines 55 
to 57 draw the walls that Impede the character’s progress. 
These walls are plotted In... You guessed It.... Color 3. 

The fact that different things are drawn In different colors 
Is critical to the game. These locations, called COLLISION 
REGISTERS, are checked by the ATARI to see If something 
(like a Player) has touched something else (like a Color 1 
wall). Notice that Colors 1 to 3 may all be the same, I.e., 
red, but the different walls must be drawn with different 
COLOR statements for collisions to work. 

60 A=PEEK(106)-32:P0KE 54279,A:P0KE 204,At4:POKE 203,0:PMBASE= 
A*256 

70 POKE 53277,3:X=50:P0KE 205,120:POKE 53256,0;P0KE 53250,150 
80 GOSUB 20 

90 RESTORE 120:Y=150:ERAX=-10 

100 FOR I=PMBASEtl024tY TO PMBASEtl280:READ B:IF B = 999 THEN 110 
105 POKE l,B:NEXT I 

no REM ***** DATA FOR PACMANl ***** 

120 DATA 28,62,119,127,254,252,248,252,254,127,126,62,28,999 
130 RESTORE 160 

140 FOR l=PMBASb + 1 536+Y TO PMBASE + 1792;READ B:IF B = 999 THEN 150 
145 POKE l,B:NEXT I 

150 REM ***** DATA FOR PACMAN2 ****** 

160 DATA 28,62,118,255,255,255,255,255,126,126,62,28,999 
17u POKE 559,62 
180 REM 

1yu REM ******MAIN LOOP ****** 

200 REM 

205 POKE 532/8.1:REM CLEAR ALL COLLISION L0CATI0NS(S0 THEY 
HOLD O’S) 

220 ST=STICK(0):S=PEEK(53279) 

230 IF S=3 then poke 764,12:RUN "D;EX5.13" 

240 X=X+(ST=7)-(ST=11):P0KE 53248,X;P0KE 53250,0:FOR J=1 TO 50: 
NEXT J 

242 IF PEEK(53252)<>0 THEN GOSUB 1000:GOTO 220 

245 IF X>220 THEN X=40 

250 POKE 53250,X:P0KE 53248,0 

260 GOTO 220 
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In line 205, we learn a new trick. To go with those 
Collision Registers, there Is this location, called HITCLR, 
at 53278. It does just what It*s name Implies... When you 
POKE It with a 1, It will clear the other Collision 
locations so that they read 0. If this Isn’t done, then 
after a collision occurred, the approplate collision 
register would be set and stay that way. You’ll see all 
this In action In a moment. Here’s a list of all the 
collision registers: 


Memory Location 
******************* 


Type of collision 
************* 


53248 

53249 

53250 

53251 


Missile 0 to Playfleld 
Missile 1 to PI ayfIeId 
Missile 2 to PI ayfIe I d 
Missile 3 to Playfleld 


53252 

53253 

53254 

53255 


Player 0 to Playfleld 
PIayer 1 to Playfleld 
PIayer 2 to Playfleld 
Player 3 to Playfleld 


53256 

53257 

53258 

53259 


Missile 0 to PIayer 
Missile 1 to PIayer 
Missile 2 to Player 
Missile 3 to Player 


53260 

53261 

53262 

53263 
53278 


PIayer 0 to PIayer 
Player 1 to Player 
Player 2 to Player 
Player 3 to Player 
Clear all collision registers 


That’s a loti They are really easy to use, however, so 
stay with me. You simply PEEK at the location that starts 
wlrn the object you are concerned with. In this example, we 
want to know If the shape. Player 0, has collided with the 
Playfleld. That means we will look at the value In 53252. 
This Is done In line 242. If It Isn’t 0 then some kind of a 
collision has occurred and we branch to the subroutine at 
line 1 000. 


270 GRAPHICS 17;P0KE 712,245 
280 ? #6;’’NOW WE ADD CHECKING 
290 ? #6;”F0R COLLISIONS WITH 
300 ? #6;" THE WALLS AND ALSO 
310 ? #6;” PRIORITY WITH THE 
320 ? #6;”0THER SHAPES.... use 
330 ? #6;”Y0UR JOYSTICK TO SEE” 
340 ? #6;”THE pacman(TM) MOVE ” 
350 ? #6;” IN AND OUT OF THE 
360 ? #6;” TUNNEL SHAPES ” 
365 FOR 1=1 TO 2000:NEXT I 
370 GOTO 30 
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1000 REM **** COLLISION SOUND **** 

1002 C0L=PEEK(53252) 

1004 IF C0L=2 THtN 1015 
1 005 IF COLol THEN 1030 

1006 ? »»YUMMYI !”:? :? 

1007 FOR 1=200 TO 0 STEP -l:SOUND 0, 1,10,8:NEXT I:? :? :? 

1008 COLOR 0:ERAX=ERAX+30:PL0T ERAX,61;PL0T ERAX+1,61 

1009 X=X + 8;P0KE 53248,X:P0KE 53250,X 

1010 GOTO 1030 
1015 SOUND 0,50,8,8 

1020 FOR 1=1 TO 30;NEXT IrSOUND 0,0,0,0 
1030 POKE 53278,1:RETURN 

From 1000 to 1005, we test to see what Is In the 
Collision register. We already know It Isn’t a zero — 
that’s how we got this far. If It’s a 2 then we know the 
Player ”hlt” (overlapped) Playfleld 2, which Is the walls of 
the tunnel. We then make a collision sound and go to line 
1030 which is ALWAYS REQUIRED to reset all collisions 
registers to hold O’s. If It Is a 1, we ran Into Playfleld 
1, which In our program Is the ’’energy pellets”, so the 
message ’’Yummy” Is printed and an approplate sound Is made. 
These lines also POKE HITCLR (53278) and return. 


Does alI that make sense to you? 

Let me repeat the basic way to use collisions: Find the 
Collision register that deals with the two Items you are 
concerned with, either a Missile or a Player on the 
left side and a Player, Missile, or Playfleld number on the 
right. Read the value In that register by using the PEEK 
command. The number that results will be either 0, 1, 2, or 
3. If It Is 0, It means you collided with yourself which Is 
meaningless. If It Is a 1, you collided with Playfleld 1, 
Player 1 , or Missile 1 depending on the register you are 
using. If a 2, It means you collided with PF 2, PLAYER 2, or 
Missile 2. A 3 means a collision with PF3, Player 3, or 
Missile 3. You can then branch to do whatever kind of noise 
or graphics you want. 


I have one last trick In this example. Line 245 allows 
the character to wraparound In the X direction. It just 
tests for a value of X greater than 200, which Is off the 
right side of the screen. By setting X equal to 40, the 
character will suddenly appear on the left! 

One part of this example doesn’t show up In the program 
listing. That’s priority, meaning ’’What will appear In front 
of what”. In other words, will a character appear to go 
Inside a House drawn on the screen, or pass In front? This 
example didn’t POKE anything Into the Priority register, so 
the defaults were used. Here are the options for the 
priority register; 
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PRIOR (623) 


ADD 


For overlapping areas of Players 

to have a third color.32 

For all 4 Missiles to have the color 

In location 711(PI ayfIeId 3).16 

ADD ONLY ONE FROM THE FOLLOWING LIST 

Pro, PF1, PO to P3, PF2, PF3, BACKGROUND.8 

PFO to PF3, PO to P3, BACKGROUND.4 

PO & PI, PFO to PF3, P2 & P3, BACKGROUND.2 

PO to P3, PFO to PF3, BACKGROUND.1 


To use this location. Just add up the options and POKE the 
TOTAL NUMBER Into 623. You can only choose one set of 
priorities, so either choose 8, 4, 2, or 1. 

A 55TM 

Remember In example 5.5, the Color Utility, how you 
could press SELECT and have all the Missiles come together 
Into a single Player? This Is how It was done. I POKEd 623 
wltn 17 for both the priority I wanted and to change the 
colors (lines 1000 to 1050). Then I simply moved their X 
locations next to each other. Remember that Missiles are 
only 2 pixels wide each. You can use them together just like 
a regular Player. The mathematics to keep track of them will 
be a little harder, that*s all. 


F>XXEL. MXDE F^LAVERO 
EXAMPLE 5.13 

You now know that you have at least 128 pixels In the Y 
direction to work with. For Single line resolution you have 
256. But so far we have been hindered by only 8 pixels of 
width. The answer Is obvious, but 1*11 mention It anyway. 
Just position two Players near each other so they match upl 
You can write some simple math to always keep them 8 apart 
In the X direction. Look at example 5.13 to see an ATARI 
logo made this way. 










EXAMr=>L.iB S. 

(32K required) 


Just In case you have gotten to this point In the 
Tutorial, and feel you haven’t gotten your money’s worth, 
example 5.14, the last program. Is an Editor to create and 
change your Player shapes. I hope you like It! Here Is how 
to use It; 

1) When the program starts. It will ask If you want to 
load In old data, or create new shapes. Choose NEW. 

2) Then Press the SELECT button. The message ’’Player # 
to edit” will appear. Pick any number from 0 to 4. 
Player 4 Is made up of the Missiles. 

3) A flashing cursor will appear In the editing box on 
the left. Press D to draw and move the cursor with the 
four cursor control keys ( the CTRL Is not needed). 

4) To stop drawing, press E (erase). Move the cursor to 
the next spot you want to draw. 

5) While continuing to edit the shape, press START to 
see the Player’s shape updated. The Player will appear 
next to It’s number. 

6) You may also move the Player you are currently 
editing anywhere on the screen by using a Joystick In 
Port 1 . 

7) You can change the size of the Player being edited 
(except #4), by pressing SELECT and choosing 0, 1, or 3 
for normal, double, or quadruple size. 

8) Press OPTION to edit a different Player. 

9) Press S to save the shapes you have made to tape or 
disk. 

10) Press L to load any saved Players back In. Disk 
users will find a set of Players on the disk already. 
Remember when you load In a set of Players you won’t 
see them until you press OPTION and request each one! 

This Editor should allow you to quickly create Players 
for any purpose. Write to us with suggestions on 
Improvements and I will Incorporate your Ideas In later 
versions of this program. The code for this also Is a great 
Tutorial on handling Players by using strings to store them 
In. Advanced users should study It. 




At this point let me see If there are any loose Ideas 
that need to be covered. First, let’s go way back to the 
game In example 5.2. You have learned all of the technical 
aspects of writing a game using PMG. I want to discuss the 
structuring of a game. This means what goes where In the 
program coae. You should be able to figure out the rest, but 
If I’ve missed anything, please write. 
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NOTE; 


Because of the special characters In this program, the 
listing be I ng ref erred to will be found a few pages on In the 
listings section of the manual. 


WHOS^ 
SPEClAl- 

CHARACtER. 



Lines 40 to 60 set the colors. Line 70 points to a 
subroutine to draw the Playflelds. Always do this toward the 
end of your program so that the main loop will run more 
quickly. The Playfleld In this case consists of Just 
plotting a lot of data. This Is similar to the earlier 
discussion on Playflelds. 


Line 80 tells you that the program hasn’t stopped, but 
Is just setting up Itself. This Is always a nice touch. 


Line 110 Is tricky. It’s another machine language 
subroutine! But this one Is far more useful than the 
earlier one. Here I set up four starting locations that are 
In a safe area of memory, right between PMBASE and 
PMBASEt768 where the Missile data starts. Since line 20 
clears this whole area out, we know It Is safe and 
available. You’ll see what goes there In a moment. 

Now, In lines 130 to 310, I POKE In the data for two 
shapes for the Pacman(tm) and two for the Squiglly Monster. 
These start at convenient Increments so I can find the 
shapes later. 

Line 330 Is the machine code which Is stored In a string. 
You may copy this line out for other programs along with 
It’s dimension statement In line 50 and It’s USR call. 


Lines 380 to 440 do the normal math that Is needed to 
keep track of X and Y for TWO Joysticks. 

Lines 450 to 480 are the neat part. First let me tell you 
what the machine language can do for you. The routine Is a 
memory move routine. It takes the values In the memory 
locations you tell It, and moves them to any other location. 
You can use It to move and entire screen of data Instantlyl 
I use It to change the shape that Is In the area where the 
data for the two Players Is stored. These lines simply tell 
the computer... 

Line 450 ; ’’Move the Pacman(tm) data from the location 
called shape2 to the Player 0 area using 20 bytes of data” 
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Line 4bO:”Same thing, but move Squiggly data to Player 1 
area" 

Line 470:”Move a different Pacman(tm) shape to the 
Player 0 area" 

Line 480;"Move a different Squiggly shape to the Player 
1 area. 

All of the moves above also take care of movement up or 
down the screen at the same time with the addition of the Y 
coordinate you want In the "move data to" location. This 
rouxine will move all 5 Players and/or the Missiles very 
quickly. The earlier machine language routine only moved 
Player 0. 

Lines 490 to 570 take care of all the Collisions that we 
might be Interested In, and each branches to a subroutine or 
makes some change on the same line. 

The scoring and sounds are straight forward.... Make a 
sound... Increment a score ...change a color. ALL of these 
depend on your Imagination, I.e., what do you want to happen 
In the game? 

Here are the lines to use for the second machine language 
routine. 


50 DIM A$(100) 



450 D=USR (ADR (A$), From Address, To Address, # of bytes to move) 


Even though I did not emphasize the use of Missiles very 
much, I hope you realize that they are handled Just like 
Players except they are two bits wide. A good example of 
moving them Is In example 5.1, lines 640 to 710. 

Your main limits are having only two pixels of width, and 
the Missile data areas all In the same stripe. This means 
you must POKE 0*s Into the data area for Missiles you don't 
want to snow on the screen, or Just move them off screen 
wlxh the horizontal position registers. 

I left a few strange things In the programs In terms of 
colors, sizes, and moving shapes off screen when not In use. 
If you are going to understand PMG, I suggest you now take 
any of my examples and start to clean up little details to 
be more to your liking. That will be your final exam... 

WILL YOU PASS? 

Scores will be mailed out on Friday. BYE!!! 
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SELECTED RROGRAM LISTIMSS 

5 REM EX5.2 (c) JL3S2: BV SANTA CRUZ EDUCATIONAL SOFTWARE. PAC 

MAN CHARACTER COPYRIGHT ATARI INC. 
le GOTO 580 

ZO FOR I=PMBASE TO PMBASE+204S:POKE I,O:NEXT I:RETURN 
30 REM MiCKKX PLAVER SETUP * € ■< € ■ »< ■ *€ ■ >€ ■ 

4.0 GRAPHICS Z:POKE ZIO,I2A;POKE ZI2 , O ; POKE 704,41 : POKE 705,4 
I:POKE 55S,52 

50 DIM A$CIOOH:POKE 523,1 

50 POKE 708,I03:P0KE 752,A:POKE 70S,A48 

70 GOSUB 590:REM DRAM BACKGROUND 

80 2 *■ WAIT A MOMENT PLEASE 

90 A = PEEK CA05} -32 : POKE 54279 , A : PMBASE=:AK255 

AOO POKE 53277,3:POKE 53255,OzPOKE 53250,A50 

AAO GOSUB 20:SHAPEA=PMBASE:SHAPE2=PMBASE+50:SHAPE3=PMBASE+AO 
O;SHAPE4=PMBASE+A50 

A20 RESTORE ABO;VA=A72:V2=A72ZKA=50:X2=A90 
A30 FOR I = PMBASE TO PMBASEHh^O : READ B 
A4B POKE I,B:NEXT I 

ASO REM XMNKK DATA FOR PACMANA MMMMM 

ABB DATA O,B,O,28,52,AA9,A27,A25,A24,A20,A24,A25,A27,A25,52, 
28,0,0,0,0,0 
A70 RESTORE 2AO 

AOO FOR I = PMBASE-t-50 TO PMBASEHh70 : READ B 
A9B POKE I,B:NEXT I 

200 REM * €« ■■ >€ ■ >€ N DATA FOR PACMAN2 >€»€»€ > €i<»C 

2AO DATA O,O,O,28,52,AA8,A25,A25,A25,A25,A27,A25,A25,52,28,O 
,0,0,0,0 
220 POKE 559,52 

230 RESTORE 250:FOR I=PMBASE+AOO TO PMBASE+A20:READ B 
240 POKE I,B:NEXT I 

250 REM MKMNi N i DATA FOR MONSTERA XltNWiM 

250 DATA 0,0,0,B,A24,2A4,2A4,254,A24,58,58,204,0,0,0,0,0,0,0 
i. O , O 

270 RESTORE 3AO 

280 FOR I = PMBASE-^A50 TO PMBASE + A70 : RE AD B 
290 POKE I,B:NEXT I 

300 REM XX-iCMK DATA FOR MONSTER2 

3AO DATA 0,B,B,0,A24,254,2A4,2A4,A24,58,58,A02,0,0,0,0,0,B,0 
,0,0,0 
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320 SCOREMOM=3:SCOREPOC-3 

330 BQhrE hn aKn HiTiriighrohr'g-ij^iiimicisx^^ HetLxiaa^emEHflii-ea 

340 ? :? ; ? :? .. aunrarri il i-=lifc«^ri^3 »« a FOR X = ± TO 30 

O : N E X T X 

3SO REM »* *€ > €>€«»€ maim LOOP ■ > €■>€• 

360 GOSUB 1030 

370 POKE 53270,1:REM CLEAR ALL COLI3IOM LOCATIONS CSO THEY H 
OLD- O ■ S> 

300 STI = STICKC03i : S = PE E K 15 3 2 7 S > 

3SO ST2 = STICK CI J 

400 IF S = 3 THEN POKE 704,12: RUN •■D;EX5.3'' 

410 V.JL=:YI+CSTI = .13J *t2 ~ CSTI = I4 J »2 
420 Y2:=:Y2+CST2 = I3J ^2“ CST2 = I4> *2 

430 XI=K±+CSTI=73-CSTA=IA3:POKE 53240,XA 
440 X2 = X2F tST2=:73 - tST2 = AAi : POKE 53249 , X2 
450 D =USR CADR CA:S> ,SHAPE2 , PMBASETA024 +YA ,205 
400 D = USRCAI>RCA:S:5,SHAPE4, PMB ASE+A200 +Y2,205 
470 D-USR CAOR CA:$5 , SH APE A , PMB ASET A024 +Y A , 205 
400 D = USRCADRCA:S:5,SHAPE3, PMB ASET A200TY2,205 

490 IF PEEKC532525=2 THEN POKE 704,200:P0KE 705,4ASSOUND 0,2 

e0,A0,0:F0R I=A TO 30:NEXT I:SOUND 0,0,0,0 

500 IF PEEK€532525=A THEN XA"XA-CSTA=75T€STA=AA5:POKE 53240, 
XA : YA=YA“ tSTA = A35*t3T €STA = A45*t3 

5AO IF PEEK€532535=2 THEN POKE 705,200:POKE 704,4A:SOUND 0,2 

e0,A0,0:F0R I=A TO 30:NEXT I:SOUND 0,0,0,0 

520 IF PEEK€532535=A THEN X2=X2-€ST2=75T€ST2=AA5:POKE 53249, 
K2 : Y2 =Y2 - €ST2 = A35 ^*3T €ST2 = A45 *t3 

530 IF PEEK€532005<>O THEN GOSUB 920:GOTO 570 
540 IF PEEK€532535=4 THEM GOSUB 090 

550 IF RND €05 N^AOO> 99 THEN COLOR 3: PLOT 35,55 : PLOT A35,65 
500 IF PEEK€532525=4 THEN GOSUB 800 

570 POKE 53278,0:GOTO 380 
580 GRAPHICS A7 
59 0 ? «6; • 

OOO ? «o;* 

OAO ? *tO ; • 

020 ? «0; • 

030 ? «o;* 

040 ? «o; • 

050 ? #*0; ■ 

OOO ? »»0; ' 

0 7 0 ? **0; * 

080 FOR 1=1 TO 3000:NEXT I:GOTO 30 

090 REM BACKGROUND K M M N >€ ■ K ' N »€ ■■> € ■ » ■>« >« M ■ >€ MN-N N ' N ' N ' N 

700 RESTORE 740:COLOR A 

7AO READ XA,YA,X2,Y2;IF XA=999 THEN 820 
720 PLOT XA,YA:DRAMTO X2,Y2 
730 GOTO 7AO 

740 DATA 20,20,20,0,20,0,0,0,0,0,0,79,0,79,70,79,70,79,70,70 
,0,50,AO,50,0,40,AO,40,AO,AO,AO,30,AO,30,20,30 

750 DATA 20,30,20,40,20,40,40,40,40,40,40,AO,20,50,20,OO,20, 
OO,AO,OO,AO,OO,AO,70,AO,70,50,70,50,70,50,40 

700 DATA 30,30,30,0,30,0,70,0,70,0,70,AO,50,0,50,30,50,40,60 
,40,00,AO,OO,50,30,50,40,50,30,00,40,OO 

770 DATA 70,30,90,30,90,30,90,50,70,50,70,30,70,20,AOO,20,AO 
O,20,AOO,OO,90,AO,90,20,80,AO,80,O 

780 DATA 80,0,A59,0,AS9,0,A59,70,A59,79,80,79,80,79,80,60,80 
,60,60,OO,OO,OO,OO,70 

790 DATA 90,OO,90,70,90,70,ASO,70,A50,70,A50,40,A40,60,A30,6 
0,A30,60,A30,70,A30,40,AA0,46,AA6,40,AA0,70 

800 DATA AOO,30,A30,30,AAO,AO,AAO,20,AAO,20,ASO,20,A40,20,A4 
0,50,A40,50,A20,50,A20,50,A20,00 

OAO DATA A50,A0,A50,30,A40,0,A40,A0,A30,A0,A30,20,A20,0,A20, 
AO,AOO,O,AOO,AO,999,99,9,9 


ME ARE GOING TO PLAY 

MITH A COMPLETE GAME 

FIRST TO STUDY THE 


FEATURES THAT THE 
ATARI€TM5 OFFERS US. 
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820 REM KMMKKKM FILL BOXES X > € W * t X M K M 

830 COLOR 2 S FOR I = I TO 20; PLOT 7 O , 3 O Hh I : D R A MT O 90,30 + I:MEKT I 

840 COLOR 3 

850 RETURN 

860 REM MMMMM SCORE FOR PAC ■M MK ' MK-M M - MM K - MK 

870 COLOR OrPLOT 35,SS:PLOT I 35,65 : SCOREP AC=:SCOREP AC + I : FOR I 

=50 TO I STEP -IrSOUNO O,I,IO,8:NEKT I 

880 GOSUB 1030:RETURN 

890 REM KM-M SCORE MONSTER M ' M KKMK-M ' 

900 COLOR 0:PL0T 35,55;PLOT 135,65;SCOREMON=SCOREMON+I:FOR I 

= 50 TO I STEP -I;SOUNI> O , I , IO , 8 : NE XT I 

910 GOSUB 1030:RETURN 

920 REM KK-MK PAC HITS MONSTER K M HM M K M -MM M KK 

930 IF PEEKC53260}=2 AND PEEK€7043=200 THEN SCOREPAC=SCOREPA 

C^5;GOSUB 1030:GOTO 950 
940 GOTO 960 

950 FOR 1=200 TO O STEP -I:SOUND O,I,lO,8:NEXT I 

960 REM KK-MK MON HITS PACMAN MMK KKK 

970 IF PEEKC5326I3=I AND PEEKC70S3=200 THEN SCOREMON=SCOREMO 

N+5:GOSUB 1030:GOTO 990 
980 GOTO lOeO 

990 FOR 1=0 TO 200 STEP I:SOUND O,I,lO,8:NEXT I:SOUND 0,0,0, 

O 

lOOO XI=60:X2=I90:VI=I72:Y2=I72 

leiO DUM=USR CADR CA53 , PMBASE + 2;00 , PMBASEHhlB24HhV , 2403 
1020 DUM=USR CADR CA:$3 , PMBASEHhSOO , PMBASEHhl024,5103 
1030 POKE 656,I:POKE 657,2:? "PACMAN= ”;SCOREPACJ" 

SQUIGILV= SCOREMON : RETURN 


4 REM EH 5.6 

5 REM CC3 JL982 BY SANTA CRUZ EDUCATIONAL SOFTWARE . WRITTEN B 
V ROBIN SHERER 

lO FOR I = i TO 8 : POKE 53247-t-I , 8 : NEXT I : GOTO 410 
20 REM MMMMM plot SHAPE MMM M M K 
30 COLOR O 

40 D = D+ CST = 63 HhCST = 73 + CST = S3-CST = 93-CST = I03-CST = H3 

50 E = E+ CST = I33CST = 93 ♦ CST = 53 - CST = 63 - tST = I03 - CST = A43 

60 FOR K=0 TO 9;FOR Y=0 TO 25;PLOT K^D,Y+E;NEKT Y:NEXT X 

70 RESTORE 150:COLOR I 

80 FOR N=I TO IOO:READ X:READ Y 

90 IF K=0 AND Y=0 THEN RETURN 

lOO PLOT X + D, Y-^E : NEXT N 

lAo ES Cl , 603 =»hHHjiH03 n EiTy WTinTniyi hjHtii « m.<i:4;i gyr[3Sh 
h jm Njri SBfs « 

±20 REM POKE 53248,30 

±40 SOUND 2,0,8,2:F0R UOL=± TO ±5 STEP O.±:SOUND 0,25,4,UOL: 
SOUND ±,±3,4,VOL 

±50 DATA 5,O, 3,±, 4, ±,5,±, 6, ±,2,2,3,2,4,2,5,2,6,2,7,2,±, 3,2,3 

,7,3,8,3,2,4,3,4,4,4,5,4,6,4,7,4,3,5,4,5,5,5,6,5 

±60 DATA 4,6,5,6,2,7,3,7,4,7,5,7,6,7,7,7, ±, 8,3,8,6,8,8,8, ±, 9 
,8,9,2,±0,4,±0,5,±8,7,±8,2,±±,4,±±,5,±±,7,±± 

±70 DATA 2,±2,7,±2,3,±3,6,±3,3,±4,6,±4,4,±5,5,±5,4,±6,5,±6,4 
,±7,5, ±7,4,±6,5,±8,3, ±9,4, ±9,5, ±9,6,±9 

±80 DATA 2,20,3,20,4,20,5,20,6,20,7,20,±,2±,2,2±,3,2±,4,2±,5 

,2±,6,2±,7,2±,8,2±,2,22,3,22,4,22,5,22,6,22,7,22 

±90 DATA 3,23,4,23,5,23,6,23,4,24,5,24,0,0,0,0 

200 REM KKKMKPLAYER SETUP MMMMM 

2±0 DIM E$C603:GRAPHICS 6:D=20;E=50:POKE 559,0:G0SUB 20:? “ 

WHICH IS THE PLAYER?":POKE 7±0,±48:POKE 7±2,±48 

220 ? "emaai = sizes tiiagifiTri = next ex . ■■_ _ 

230 C± , 603 ="hHh JHEl ■■^TaFr 3:4uii:l;?: h JHm 
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4 REM EK5.8 

5 REM CC) ±982 BY SANTA CRUZ EDUCATXONAE SOETMARlE CROBXN SHER 
ER> 

±e GOTO 30 

20 FOR X=:PMBASEHh±024 TO PMBASE 4^X536 : POKE X , O : NEKT X : RETURN 
30 GOSUB 200:REM DRAM MOUNTAXNS 

40 DXM E:$C60} 

50 GOSUB 300:REM DRAM STARS 

50 POKE 7±0,0:P0KE 7X2,O:POKE 704,X23 

70 GOSUB 380:REM SETUP PLAYERS 

BO POKE 204 , AHh4 : POKE 203,0:P0KE 205,X20 

90 E$ cx , 603 =**hhh JHm "■ gMrjrTaTaTTTTgtTK■ IHm rjTrm^TKHm\ jiisias 

jirsT vrjiKTS4i <»fa4 • 

XOO REM POKE 53248,30 

XXO REM M-»44itMAXN LOOP ' M ' KKKMii ' MNK 

X20 SOUND 2,0,8,2:r0R MOL=X TO X5 STEP O.X:SOUND 0,25,4,M0L: 
SOUND X,X3,4,UOL 

X30 A = USR CADR tE53 , STXCK COJ J 
X40 NEXT UOL 

X50 FOR UOL=X4 TO O STEP -O.X;SOUND O,25,4,UOL:SOUND X,X3,4, 
UOL 

X50 A = USR CADR CE$} , STXCK C03 3i 
X70 NEXT UOL 

XOO XF PEEK C53279J =3 THEN POKE 754, X2: RUN ''D : EX5.9'* 

X90 GOTO XXO 

200 REM NNMK plot BACKGROUND KNNXK 

2X0 GRAPHXCS 8HhX5 : RESTORE 260 

220 COLOR X 

230 READ X,Y:PLOT X,Y 

240 READ X,Y:XF X>900 THEN RETURN 

250 DRAMTO X,YHhXO:GOTO 240 

250 DATA O,X57,27,X55,39,X55,49,X55,57,X57,57,X58,59,X58,74, 
X54,87,X70,87,X7X,90,X59,95,X40 

270 DATA XXO,70,XX2,55,XX4,50,XX6,53,X27,93,X30,97,X40,97,X5 
3,53,X59,57,X55,84,X68,9X,X75,X03,X8X,X23 

280 DATA X90,X74,X99,X74,205,X55,207,X49,229,X33,245,X55,255 

,X33,27X,X20,283,X55,287,X72,29X,X54,300,89,305,75 

290 DATA 3X0,53,999,999 

300 REM STARS MNNNN 

3X0 TRAP 370 

320 RESTORE 340 

330 READ X,Y:PLOT X,V:GOTO 330 

340 DATA 2,4,5,8,9,Xe,X3,43,34,56,7,3,23,55,X23,45,300,57,30 
X,55,245,34,234,49,25X,58,24X,X33,X23,55,57,98 

350 DATA X2,54,75,58,XX9,XO,X33,43,4,55,7,93,203,55,X2,45,X7 
8,57,X45,55,45,34,X87,49,X23,58,2X,X33,243,55,XX6,74 
350 DATA X23,5,X55,7,2X3,8,295,X2,295,34,294,55,230,55,230,5 
, 78,9 

370 RETURN 

380 REM SETUP PLAYERS NKNM 

390 A = PEEK CXe5>-40 S POKE 54279 , A : PMBASE = A4»255 

400 GOSUB 20:REM CLEAR PM AREA 

4X0 POKE 53277,3:REM TURN ON PM DMA 

420 Z=20:REM XNXTXAL Y POSXTXON OF SHXP 

430 X=X50:REM XNXTXAL X POSXTXON OF SHXP 

440 POKE 53248,X:POKE 53249,X:REM POSXTXON SHXP CPLAVER09 AN 
D FLAME CPLAYERX3 
450 RESTORE 480 

450 FOR X = PMBASE^X024HhZ TO PMBASE-^X280 : READ SHAPE : XF SHAPEO 

O THEN POKE X,SHAPE:NEXT X 

470 POKE 523,X:REM SET PRXORXTY 

480 DATA 8,50,X25,X95,X25,50,24,X25,X55,X29,90,e,8,e 
490 POKE 559,52 

500 RETURN 
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2t4.0 ft-PEEK C J..06 J -X6. : POKE 5 4-2 71? , A : PO K E 2 O 4 , A + 4- : P O K E 203,0;PMBA 
SE = 0^^2 5 6 

250 POKE 5322 ?■ , 3 : POKE 204,40sP0KE 5 3 2 4 S , X 5 O ; P O K E 205,X20:P0K 

E 53255,0 

250 FOR I=PMBASE+i024 TO PMBASE+X28O:POKE X,0:HEKT I 

220 RESTORE 2SO 

280 FOR .T™PMBASE + XX55 TO PMB ASE + X20S : RE AD B SPOKE I,BsHEKT I 

2SO DATA 8,8,50,50,X25,X25,XS5,X95,X25,X25,50,50,24,24,X25,X 
25,X55,X55 

300 DATA X2S,X2S,SO,SO,90,SO,55,55,35,35,35,35,24,24,24,24,2 
4,24,24,24 

3X0 DATA 50,50,X25,X25,255,255,X25,X25,50,50,24,24,O,O,O,O,O 

320 POKE 559,52 
330 REM 

340 REM KiOCi w^XMAIM LOOP K K '■ ! <■ « ■■>«■»* 

350 REM 

350 XF STRXGCe3=:0 THEN GOSUB 20 s FEAG = 0 
320 ST = STXCK COl s S = PEEK C5322S3I 
380 XF S=5 THEN GOSUB 520 

390 XF S=3 THEN POKE 254,X2:POKE 53255,OsRUN “DsEH5.2" 

400 A=:USR CADR CE$> , STXCK C03 > : GOTO 350 

4X0 GRAPHICS X2:POKE 2X2,X48 

420 ? t*5;" THXS NEKT EKAMPEE 

430 ? «5;'« SHOMS VOU THE 

440 ? #*5 ; "DIFFERENCE BETMEEN A" 

450 ? t«5 ; "NORMALLY DRAMN SHAPE" 

450 ? «t5;"AND A PLAYER. . . . use> " 

420 ? t*5;"YOUR JOVSXiCk TO SEE" 

480 ? t«5;"HHXCH IS THE raDEPUCI! " 

490 FOR X=X TO 3000:NEXT X:GOTO 2X0 
500 REM PLOT SHAPE 

5X0 COLOR X 

52 0 D = DHhCST = 5J-l-CST = 25 + CST = 5>-CST = 9J-CST = XOJ-CST = XX> 

5 30 E = E+CST = X35 + CST = 9J^CST = 53i-CST=:5J-CST = X03-CST = X4> 

540 RESTORE 320 

550 FOR N=X TO XOOSREAD X:READ Y 
550 XF X=0 AND Y=0 THEN XXO 
520 PLOT X^D,Y+ESNEXT N 

580 XF FLAG=0 THEN COLOR O:GOTO X30 
590 RETURN 

500 FOR X=X TO 8:FOR Y=8 TO 25SPLOT X+D,Y+E;NEXT YSNEXT X 
5X0 RETURN 

520 DATA 5, O, 3, X, 4, X, 5, X, 5, X, 2,2,3,2,4,2,5,2,5,2,2,2, X, 3,2,3 
,2,3,8,3,2,4,3,4,4,4,5,4,5,4,2,4,3,5,4,5,5,5,5,5 

530 DATA 4,5,5,5,2,2,3,2,4,2,5,2,5, 2,2,2, X, 8,3,8,5,8,8,8, X, 9 
,8,9,2,XO,4,XO,5,XO,2,XO,2,XX,4,XX,5,XX,2,XX 

540 DATA 2,X2,2,X2,3,X3,5,X3,3,X4,5,X4,4,X5,5,X5,4,X5,5,X5,4 
,X2,S,X2,4,X8,5,X8,3,X9,4,X9,5,X9,5,X9 

550 DATA 2,20,3,20,4,20,5,20,5,20,2,20,X,2X,2,2X,3,2X,4,2X,5 

,2X,5,2X,2,2X,8,2X,2,22,3,22,4,22,5,22,5,22,2,22 

550 DATA 3,23,4,23,5,23,5,23,4,24,5,24,0,0,0,0 

520 REM SIZES NNKM ' K 

580 ? S? S? "PRESS 8, X, OR 3 FOR SIZE";? "0000301 = SIZES 

= NEXT EX." 

590 POKE 254,255 
200 PK=PEEKC254) 

2X0 XF PK=50 THEN POKE 53255,O:RETURN 

220 IF PK=3X THEN POKE 53255,XSRETURN 

230 XF PK=25 THEN POKE 53255,3SRETURN 

240 GOTO 200 
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3 REIN CO 1.982 BV SANTA CRUZ E BU C A T T ON AE SOFTMARE CROBXN SHER 
ER3 

4 REM EK 5.9 

5 FOR I-l TO 8 : POKE 532-CZ +1 , O ; NEKT X 

8 GOTO TOO 

1.0 BXM ES CGOl 

20 E5f cx , 6o;> =**hHh jHCs] ra:4;iujpr hjiHfii ra :w r rscr n jHrnN jasi5iZM ’»raK 

JlSTsJQGSSCjB’va^ • 

30 A = REEK: cxoei “X6 : POKE 54.2Z9 p A : POKE 204- p AHh4 ; POKE 203 , O : PMBAS 
E = A^t2S6 

40 POKE S59p82;POKE S32Z7,3:POKE Z04p40:P0KE 205pX20:P0KE 53 

2 5 6 , X 

50 FOR X = PMBASE-I-X024 TO PMB ASE-fr-.X280 : POKE X , O : NEXT X 

80 FOR X=PMBASE+XXOO TO PMBASE>XX27:REAB B:POKE X,B:NEXT X 

70 BATA 8p60pX28pX9SpX26p60p24pX2ep.Xe5,X29,0,90,90,68,38,38, 
24. p 24 p 24 p O p 24,80 , X28,255 p X28,80,24 , O 
75 POKE 53248pX50 

80 A=:USR CABR CE:$> p STXCK COl 1 : XF PEEK C532791 =3 THEN POKE 784 , X2 
:POKE 53258pO:RUN "BzEXS.XO” 

90 GOTO 80 
XOO GRAPHXCS X7 
X02 ? »*8;' 

X04 ? **8 ; • 

XOO ? W8;* 

X X O ? »8; * 

X20 ? «8j' 

X 2 5 ? «8;* 

X30 ? «8;* 

X40 ? **8 ; • 

X50 2 «8; • 

XOO ? tt8;‘ 

X82 FOR X=X TO 3000:NEXT X:POKE 752,X 
X85 GRAPHXCS 7:POKE 7X2,X48 

XOO 2 "MOVE PLAYER BOTH BXRECTXONS” : 2 “PRESS TO GO ON 

X90 GOTO XO 

2000 REM ■>» « ■> < ■> € ■■> € ■ PLOT SHAPE *tM>€>€M>t 

20X0 COLOR X 

20X5 RESTORE 2X00 

2020 FOR N=X TO XOO:REAB X:REAB V 


3 REM tCJ X982 BY SANTA CRUZ EBUCATXONAL SOFTMARECROBXN SHER 
ERl 

5 REM EX5.XB 

XO FOR X=:X TO 8 : POKE 5324 7TX , O : NEXT X : POKE 559 , O : GOTO 30 
20 FOR X = PMBASE + 5X2 TO PMBASEHhX280 ; POKE X,0:NEXT X : RETURN 
30 GRAPHXCS 0:2 :2 :2 PRESS [HICOIXII TO GO ON“ : POKE 752,X 

40 2 :2 '• PRESS glMWiTiyi FOR SXNGLE LXNE RESOLUTXON P 

LAYER** 

50 2 :2 ** PRESS earrjTfii for bouble lxne resolutxon p 

LAYER** 

70 POKE 704,40 

80 PMB=PEEKCX081-X8 
90 POKE 54279,PMB 

XOO PMBASE~PMBN^258 

XXO POKE 53277,3:GOSUB 20:POKE 559,34 
X20 X=X25:Y=XXO:YSAME=XOO 

X30 POKE 53258,0:G0T0 200 

X40 REM M MAXN LOOP NNKNKKK 

X50 P=PEEKC532791 

XOO XF P=5 THEN POKE 559,62:POKE 53248,XOO 

X70 XF P=8 THEN POKE 559,48:POKE 53248,XOO 

X80 XF P--=:3 THEN POKE 784, X2: RUN **B:EX6.XX** 

X90 GOTO X50 


ME MENTXONEB THAT 
YOU MUST BE CAREFUL * 

MHERE YOU PLACE THE * 

PLAYER7MXSSXLE BATA.* 
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200 REM 

2±0 REM SXNGLE EXME RESOLUTXON »i M M X >€ M M K 

220 REM 

230 RESTORE 290sCNT=0 

24.0 FOR X = PMBASE + X024-«-V TO PMBASEHhXSOO 

250 REAO B:XF B=0 THEN 300 

250 CMT=CMT+i 

220 POKE X,B 

280 NEXT X 

290 BATA ±24,2X4,2X4^254,±24,58,68,204,O^O,O 
300 REM 

3X0 REM BOUBL-E L.XNE RESOEUTXON XXMXXX 

320 REM 

330 RESTORE 290:CMT=0 

340 FOR X = PMBASEHhSX2 + V TO PMBASE-l-e40 

350 REAB B:XF B=0 THEN 390 

350 CNT=CNT+X 

320 POKE X,B 

380 NEXT X 

390 GOTO X50 


4 REM EX5.X3 

5 REM CCJ X982 BV SANTA CRUZ EBUCATXONAL. SOFTWARE CROBXN SHER 
ER> 

XO FOR X=X TO 8:POKE 53242+X,8;NEXT X:GOTO 240 

20 FOR X=PMBASE+X024 TO PMBASE+X292:POKE X,0:NEXT X;RETURN 
30 REM XXX -X X PLAVER SETUP KXXXX 

40 GRAPHXCS 2!POKE 2X0,0;P0KE 2X2,0!P0KE 204,4X:P0KE 205,4X: 

POKE 559,52 

50 A=PEEKCX655-24sPOKE 54229,A:POKE 204,A+4;P0KE 203,O:PMBAS 

E = A*t2:55 

50 POKE 53222,3 ; X = X50 :POKE 205, X20;POKE 53255,0:P0KE 53250, X 
50 

20 GOSUB 20 
80 RESTORE XXO;V=X50 

90 FOR X = PMBASE + X024 + V TO PMBASE + X209 S REAB B : XF BOO THEN PO 
KE X,B;NEXT X 

X08 REM XXX 'X' X BATA FOR FXRST HALF 

XX8 BATA 2,2,2,2,2,2,2,2,2,4,4,4,8,XX2,O,8,O 
X28 RESTORE X58 

X38 FOR X=:PMBASE + X535 + V TO PMBASEX292 : REAB B S XF B<>8 THEN P 
OKE X,B:NEXT X 

X48 REM XXX X X BATA FOR 2NB HALF XKKKM 

X50 BATA X50, X58, X50, X58, X58, X68, X58, X58, X58, X44, X44, X44 , X35 
,X35,0,0,0 
X50 
X55 
X52 
X58 
X20 
X80 
X90 
200 
2X8 
228 
225 
230 
240 
250 
250 
228 
280 
298 
300 
3X0 
320 


POKE 559,52 

? ••• X5 BXT MXBE SHAPE" 

POKE 252,X 

2 " < = = = =; USE JOVSTXCK = = = = = >" 

REM 

REM XXXXXX MAXN loop MXMXXM ' 

REM 

XF STRXGC83--=8 THEN GOSUB 20sFLAG = 8 
ST = STXCK C65 : S = PEEK C53229> 

XF S=3 THEN POKE 254,X2:RUN "BsEX5.X4" 

X = XHh CST = 2> - CST-XXa : POKE 53248, X:POKE 53250, X + 8 
GOTO 200 
GRAPHXCS X2 
2 «5 ; • 

2 «6 ; • 

2 #»5 ; • 

2 t*5 ; * 

2 «»6 ; • 

2 «5 ; • 

2 »6 ; • 

FOR X=X TO 3000:NEXT X:GOTO 48 


BO YOU WANT MORE 
COMPLICATEB SHAPES2 
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Don’t forget to ask for my other lessons teaching you about all 
of the great GRAPHICS and SOUND tricks that the ATARI 
computers can do-the TRICKY TUTORIALS'” for 16K: 


#1 — DISPLAY LISTS (many Graphics Modes at the same time!) 

#2— SCROLLING (move your Graphics and text around 
smoothly) 

#3 — PAGE FLIPPING (a professional looking way to redraw 
many screens of text or graphics) 

#4 — BASICS OF ANIMATION (a beginner’s lesson In moving 
shapes around the screen) 

#5 — PLAYER MISSILE GRAPHICS (Learn to write a PACMAN'” 
type game of your own!) 

#6 — SOUND AND MUSIC (from single notes & chords to songs 
& special effects, I explain all) 

#7 — DISK UTILITIES (Utility programs to help you useyourdlsk 
drives (32K) 

#8 & 9 Coming soon to a blackboard near you! 



Trie Professor 
KNOWS WHAT 
HE iSTAUKiNe, 

about 








TRICKY TUTORIAL #5 


Have you ever wondered how THEY program all those great 
games you see in the arcades? Now you will be able to study all 
the basics of constructing animated games on the ATARI (tm) 
computers. This Tutorial includes 14 main programs with over 
25 examples, including a Color Selection Utility, A Piayfield 
editor, and a Player Missile Shape editor. Some of the topics 
explained in the 50 page manual and in the included programs 
are: 


Player Shapes 
Priority 
Collisions 
Reserving Memory 
Single/Doul;)le Line Resolution 
How to Animate 
Size Control 

A COMPLETE GAME EXAMPLE 
TWO MACHINE LANGUAGE UTILITIES 


The program will run in 16k tape machines except for the 
Piayfield and Player utilities, which are not necessary to enjoy 
and use the Tutorial. These utilities and disk users need 32k of 
memory. As always, you have our money back guarantee! 


Many other fine programs are available from: 



BY ROBIN ALAN SHERER 


